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SYSTEM AND METHOD OF DEVICE INTERFACE 
CONnCURATION FOR A CONTROL SYSTEM 



TECHNICAL FIELD OF THE INVENTION 

This invention is related in general to the field of control system. More |>articularly, the invention 
is related to system and method of device driver configuration for a control system. 

5 BACKGROUND OF THE INVENTION 

In a fully automated environment, appliances that change the various parameters of the environment 
can be inked to a control area network (CAN) and a computer-based controller. The appliances may include 
heating, ventilation and air conditioning (HVAC) systems, lighting systems, audio-visual systems, 
telecommunications systems, security systems, surveillance systems, and fire protection systems, for 
1 0 example. One or more easy-to-use user interface, such as a touch panel, may be electronically linked to the 
control area network to accept user input and display current system status. AMX Corporation of Dallas, 
Texas designs and manufactures such networked appliance control systems. 

SUMMARY OF THE INVENTION 
1 5 Accordingly, there is a need for a system and method of device interface configuration For a control 

system. 

In accordance with the present invention, a system and method of device interface configuration For 
a control system are provided which eliminate or substantially reduce the disadvantages associated with prior 
control systems. 

20 In one aspect of the invention, a control system comprises a master controller and at least one device 

coupled to the master controller via a network. At least one generic device interface module resides on the 
master controller, where the device interface module defines a basic protocol for interface with any device. 
Configuration information associated with the at least one device is used to tailor the at least one generic 
device interface module to communicate and operate with the at least one device. 

25 In another aspect of the inventicm, a method of communicating with a device in a control area 

network includes the steps of automatically obtaining configuration information associated with the device, 
where the configuration file includes communication and operating protocol of the device. A specific 
instance of a generic device interface object is then generated using the configuration information associated 
with the device, and 
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communication with the device is then perfoimed with the specific object instance. 

In yet another aspect of the invention, a control area network includes a master controller, and at least 
one device coupled to the master controller via a local area network. At least one genen'c device interface 
object resides on the master controller, where the at least one device interface object defines a basic protocol 
5 for interface with any device. A configuration file associated with the at least one device is used to tailor 
the at least one generic device interface object to generate a specific interface object instance operable to 
communicate and operate with the at least one device. 

BRIEF DESCRIPTION OF THE DRAWINGS 
10 For a better understanding of the present invention, reference may be made to the accompanying 

drawings, in which: 

FIGURE 1 is a simplified top-level block diagram of a system and method of coupling one or more 
control systems to the Internet constructed according to an embodiment of the present invention; 

FIGURE 2 is a more detailed block diagram of a system and method of coupling one or more control 
1 5 systems to the Internet constructed according to an embodiment of the present invention; 

FIGURE 3 is a more detailed block diagram of a master controller with a system and method of 
device interface configuration constructed according to an embodiment of the present invention; 

FIGURE 4 is a flowchart of a process for bringing a new device on-line according to an embodiment 
of the present invention; 

20 FIGURE 5A is a block diagram of a process for configuring a device interface object according to 

an embodiment of the present invention; 

FIGURE 5B is a block diagram of an exemplary screen for installing a new device according to an 
' W embodiment of the present invention; 

FIGURES 6A-6F are exemplary command windows for programming commands according an 
25 embodiment of the present invention; and 

FIGURES 7A-7C are exemplary conditional variable windows for programming conditional 
variables according to an embodiment of the present invention. 

DETAILED DESCRIPTION OF THE INVENTION 
30 FIGURE 1 is a simplified top-level block diagram of a system and method 10 of Internet control 

system which couple one or more control systems to the Internet constructed according to the teachings of 
the present invention. The implications of employing system and method 10 of the present invention are the 
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ability to communicate with, control, and be controlled by one or more Internet nodes or Internet applications 
that act as one or more devices in a control system connected by a control area network (CAN). These 
Internet applications may include web browsers, web server applications of information content providers, 
and email applications. In other words, the geographical and communication protocol boundaries are 
5 transparent between a local control area network and the Internet, so that the Internet, web information 
content providers and web browser applications become devices in the control system. By definition, a 
device in the control system can send control commands to and/or receive control messages from a master 
controller on the control area network. HereinaAer, the word Internet may be also used to refer to an Intranet 
or the World Wide Web and vice versa. 

10 System 10 includes a control network portal 12 coupled between the Internet 22 and one or more 

control area networks 30 and 3 1 . Control area networks 30 and 3 1 are local area networks operating under 
transport protocols such as Ethernet, and AXLink and FHASTLink<S> of AMX Corporation (Dallas, Texas) 
that interconnect a variety of devices, appliances and/or equipment. The underlying network connectivity 
34 may be wired, wireless, power line carriers, or any suitable transmission medium. Coupled to control area 

1 5 networks 30 and 3 1 are a plurality of devices, appliances and/or equipment, including control area network 
user interfaces (CAN UI/F) 35, master controllers 36, and Internet appliances 37-39. Some devices may be 
coupled to control area networks 30 and 3 1 via additional intermediate communications devices, such as an 
RS 232 controller (not shown). 

Control area network user interface device 35 is any device that is capable of receiving user input 

20 and displaying or indicating control network status. For example, a touch panel, a computer terminal with 
a monitor, keyboard and pointing device, and any device with similar functionalities may serve as control 
area network user interface 35. As described in detail below, with the use of control area network portal 12 
of the present invention, Internet applications are also capable of functioning as control area network user 
interface devices without the use of custom and dedicated applications on the user's end. 

25 Master controller 36 is generally a CPU-based controller that controls the communications among user 
interface 35 and Internet appliances 37-39. It is operable to receive user inputs received by user interface 
devices, such as commands, and instruct the appropriate Intemet appliance to act according to the command. 
Master controller 36 may also poll each device in control area network 30 periodically to monitor its status. 
The system status and/or the status of each device may be sent to control area network user interface devices 

30 for display. 

Intemet appliances 37-39 are devices that can receive commands from master controller 36 and operate or 
act according to the command. Intemet appliances 37-39 may include equipment that affect or monitor the 
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various parameters of the premises. For example, Internet appliances 37-39 may include heating and air 
conditioning, lighting, video equipment, audio equipment, sprinklers, security cameras, infrared sensors, 
smoke detectors, etc. in a residential or commercial control area network. Household appliances, such as 
a hot tub, fireplace, microwave oven, coffee maker, etc. may also be Internet appliances coupled to the 
5 network. Internet af^liances 37-39 may also be capable of providing a current status of its operational state 
to master controller 36, such as on/off, temperature settings, current ambient temperature, light intensity 
settings, volume settings, threshold settings, and predetermined alphanumeric strings reflective of operational 
states. 

Master controller 36 is also operable to receive user input from nodes of the Internet 22 via control 

10 network portal 12. Connected to Internet 22 are content providers 25 and 26, which may also function as 
control area network user interface devices. Content providers 2$ and 26 are typically web servers that 
generate and provide static and/or dynamic information and content in the form of web pages. Content 
provider applications executing on the web server are able to m ine data stored in databases (not shown). The 
web pages are typically developed with hypertext markup language (HTML), and various other scripting 

1 5 languages and programming environments such as M icrosoft Active Server Pages (ASP), Common Gateway 
Interface (CGI), Internet Server Application Programming Interface (ISAPI), JAVA, ActiveX, Cold Fusion, 
etc. that make the web pages more dynamic and interactive. 

Also connected to the Internet 22 are web browsers 23 and 24 that may also serve as control area 
network user interfaces. Web browsers 23 and 24 are application programs that can be used to request web 

20 pages from content providers 25 and 25 and decode the web pages. Web browser applications include 
NETSCAPE NAVIGATOR and MICROSOFT INTERNET EXPLORER, for example. Typically, a user 
executes a web browser application on her personal computer and accesses the World Wide Web via a 
dial-up connection to an Internet service provider. The Internet or World Wide Web may also be accessed 
via other means such as cable modems and digital subscriber lines (DSL). The user makes a request for a 

25 particular web page or particular web site by entering or specifying a uniform resource locator (URL). The 
URL is associated with an Internet protocol OP) address of the specified web site. Every computer connected 
to the World Wide Web and Internet has a unique IP address. This address is used to route message packets 
to specific computers and users. Internet protocol or IP is the message transport and communications 
protocol of the Internet and World Wide Web. 

30 When the web browser requests a certain URL, a connection is first established with a web server 

of a content provider that is addressed by the URL. A hypertext transport protocol (HTTP) request is then 
issued to the web server to download an HTML file. The web server receives the request and sends a web 
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page file to the web browser, which decodes the file to display information in specified format on the screen. 
Web pages with dynamic content provided by gateway interfaces such as CGI and ISAFI are executable 
applications that are ran by the web server upon user request. The executing gateway application is able to 
read parameter information associated with the request and generate an output in the form of an HTML file 
5 in response to the parameter values. Another way to add dynamic and interactive content to web pages uses 
ASP. ASP scripts are server-side executable scripts that are directly incorporated in the HTML web pages. 
Upon request for the page, the web server executes the ASP script in response to input parameter values and 
generates the web page with dynamic content. 

Using control network pc^l 12, users may access control area networks 30 and 3 1 via web browsers 

10 23 and 24 accessing web pages provided by control network portal 12 or value-added web pages provided 
by content providers 25 and 26. For example, a user who has a control area network deployed in her luxury 
residence to control various aspects of the home environment may use a web browser application to remotely 
monitor her home. She may change the temperature setting to decrease energy use, for example, because she 
will be leaving on a business trip straight from work. She may also use the surveillance cameras to visually 

1 5 ensure security has not been breached. She may even be able to remotely program her VCR to record certain 
favorite programs that will be broadcast while she is away. 

An example of value-added web pages provided by content providers is the provision of an interactive 
version of the television programming web page, www.tvguide.com. A user may request this web page, 
determine available program choices, and click on a certain program. Options may be provided to enable 
' 20 the user to turn on the television and tune to a particular channel scheduled to broadcast the selected program 
or to program the VCR to record the selected program. 

Another example of value-added web pages provided by content providers is the provision of a 
secured web page that an electric company may access to slightly raise the temperature settings of the air 
conditioning systems of its participating customers in anticipation of high demand brown out conditions. 
25 Yet another example is a web page that a security company may use to access, monitor and control the 
security, surveillance and fire protection systems of its customers. 

FIGURE 2 is a more detailed block diagram of a system and method 10 of coupling one or more 
control system to the Internet constructed according to an embodiment of the present invention. Control area 
network portal 12 may include a web server 13 coupled to the Internet 22. Web sender 13 is also coupled 
30 to an Internet appliance (I A) server 1 4, which may also be coupled to a control network server 40. Control 
network server 40 is coupled to control area network 30 that links several appliances and systems, such as 
fire protection systems 50, heating, ventilation and air conditioning (HVAC) systems 51, lighting systems 
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52» audio and visual systems 53, and security systems 54. Control area network 30 is also coupled to user 
interface devices 55 and master controller 36. 

It may be noted that control network portal 1 2 may be implemented by a single stand-alone system 
that has sufficient memory and processing power or several separate systems with distinct functions as shown 
5 in FIGURE 2. Web server 1 3 is operable to receive requests of web pages from web browser 23 and to 
respond by generating and providing the requested web pages. The information content of the web pages 
may be dynamically obtained by communicating with lA server 1 4, which is operable to communicate with 
master controller 36 via control network server 40 to obtain status and other information. Control network 
server 40 is used only if there is protocol conversion or other control issues needed to operate the control area 
10 network. It may be thought of, logically^ that LA server 1 4 is directly coupled to the network and functions 
as a device on the network. Commands entered at a web browser are sent to web server 13, which relays the 
commands to master controller 36 via I A server 1 4 and control network server 40. Master controller 36 then 
instructs appropriate appliances and/or systems in the control network to act according to the received 
command. 

1 5 FIGURE 3 is a more detailed block diagram of a master controller 36 with a system and method of 

device interface configuration constructed according to an embodiment of the present invention. Master 
controller 36 includes an installation sofbvare 100 which may be used to install and configure the 
components in a control system. Installation software 100 defines a generic device interface object 102» 
which may be configured by device interface object configuration files 104 to instantiate objects 106-1 10 

20 tailored to specific devices made by specific manufacturers, such as a television set 1 12, a VCR 1 14, and a 
CD changer 1 16, for example for a home entertainment application. Each device may also include its own 
embedded configuration file for upload to master controller 36 when the device is brought on-line. Each 
configuration file 104 includes device-specific protocol information related to a specific device. Instances 
1 06- 1 1 0 enable master controller 36 to tailor its installation software 1 00 for the installation of the specific 

25 devices and further allows master controller 36 to communicate with the specific devices. 

This configuration technique is shown in more detail in FIGURE 5A. Instances of generic device 
interface object 102 are generated by reading or loading configuration files which describe specific devices 
made by specific manufacturers. For example, loading a configuration file 1 60 of device number 1 1 1 made 
by company ABC causes an instance 162 of generic device interface object 102 that has knowledge of the 

30 specifics of that device to be generated. Similarly, the same generic device interface object 102, when 
characterized by a configuration file 164 for device number 124 made by company ABC, generates an ABC 
device 124 interface object instance 166. Configuration file 168 describing the characteristics of device 
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number 260 manufactured by company XYZ causes an XYZ device 260 interface object to be instantiated 
from generic device interface object 102. Further, configuration file 172 describing the characteristics of 
device number 143 manufactured by company MN causes an NfN device 143 interface object to be 
instantiated from generic device interface object 102. With the system and method of the present invention, 
5 device drivers for new devices may be generated in substantially shortened development time. 

FIGURE 4 is a flowchart of a process 120 for bringing a new device on-line according to an 
embodiment of the present invention. When a new device is first "plugged" into the control area network, 
it communicates with master controller 36 to announce its presence. The information the new device 
conveys to master controller 36 may include a manufacturer name and device type. With this information, 

10 master controller 36 may display an unattached hardware icon representing the new device. Master 
controller 36 queries the new device to get its configuration file information, as shown in block 122. Master 
controller 36 then examines its loaded configuration files in block 124 to determine if a configuration file 
for the new device exists, as shown in block 126. If a configuration file for the new device does not exist, 
then a configuration file is obtained from the new device over the control network link, as shown in block 

15 128. The configuration file is then saved into a directory, as shown in block 130. If the configuration for 
the new device does exist, then the configuration file is compared with the configuration file information 
obtained from the new device. The configuration file infonnation may include a file name and a version 
number. If the pre-existing configuration file in master controller 36 does not have the same or a later 
version than the configuration file in the new device, then the newer version configuration file is obtained 

20 from the new device and saved, as shown in blocks 128 and 130. Operating in this manner, the newest 
available version of the configuration file is automatically loaded into master controller 36. 

In block 134, the configuration file is displayed or otherwise indicated as an unattached software 
object icon on a tool bar or somewhere on the screen. Recall that the unattached new device icon is also 
displayed on the screen. At this point in the installation process, the user may provide some form of input 

25 to associate the unattached software object with the unattached new device, as shown in block 140. For 
example, this may be accomplished by dragging the unattached software object icon onto the unattached new 
device icon or vice versa, as shown in block 136. FIGURE 5B is an exemplary screen shot 190 illustrating 
this concept, where object interface icons 162-174 are associated with device icons 192-198, respectively. 
Once this step is performed, a specific device interface object can be instantiated, as shown in block 138. 

30 Ahematively, the interface object instances may be generated when the configuration file is loaded in block 
128 or upon startup when all configuration files 104 are loaded into installation software 100 prior to 
bringing the new device on-line. The process ends in block 142. 
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It may be seen that device object configuration files are what gives generic device interface object 
the specific details about certain devices. An example of a device object configuration file and brief 
description are provided below: 

S [Device Infomiation] 

Manufactarer=P3 Partner 

Device Naine=Test File Version 1.0 

ToolBar Location=Misc 

Hardware Name=A/V Device 
10 MfgNum^lS 

Device Num= 17 

Toolbar lcon=Toolbarlcon.bmp 

Icon Active^Activelcon.bmp 

icon lnactive=lnactiveIcon.bnip 
15 Toolbar Location=AudiQ/Video 

Attadunent Text^Press the ID button on the keypad four times 

[Device Settings] 
Failed Response Delay=2000 
20 Host Info-HEX 

[Commands] 
LEDl On^^55 
LEDl Off^,0 
25 Set LEDl LeveM^LED One Uvel% 
Set Config Paranis==4,"Setup",S0D^A 

[Events] 

Keyl Press=10,l 
30 LEDl OfIM.?,0 
Releasc=»10,0 

Scmp Complete^^IO.^Setup Completed!** 
[Variable Definition] 
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level LED One Level=0,{0^55) 
state JCON='OFP.{*ONVOFr) 

[Variable Get] 
5 ICON(ONl=5.?,?;i55 
1CON[OFF1==5.?,?,0 

LED One Level=4,?,%L£D One Levei% 
Button PushecN10»%Button Pu^ed% 

10 [Variable PutJ 

LED Two Lcvcl=5 •/oLED One Lcvcl% 

[Initialization] 

Init ]=Set Conflg Params 

15 

It may be seen that the configuration file may be divided into sections by section headings for easy 
human readability. The fonnat in which the infonnation is presented is ]abel==data, where the label follows 
a generally predetermined form and indicates what infonnation follows the equal sign. The order in which 
the information is presented is not fixed. Therefore, the "Commands" section may come before "Device 

20 Information", and the "Device Num" may come before "Mfg Num", for example. 

The first section. Device Information, provides data on the make and model of the device, as well 
as a version number of the configuration file. The "Hardware name" label is used to provide the name of the 
device used for the unattached hardware list. The "Mfg Num" and "Device Num" are unique identifications 
used to identify the maker and model of the device. The "Toolbar Icon" file, ToolbarIcon.bmp provides an 

25 icon to be used to represent the unattached hardware device on the tool bar. Additional icon bitmaps, 
Activelcon.bmp and Inactivelcon.bmp, may also be provided for additional display functionalities. The 
"Toolbar Location" label provides a location on the tool bar to locate the device icon. "Attachment Text" is 
the text that will be displayed on the screen providing a brief instruction on how to bring the device on-line. 
The second section. Device Settings, provides information on communication with the device. For 

30 example, the "Failed Response Delay" provides the number of milliseconds to wait for a response if failure 
occurred. "Host Info" provides hexadecimal, decimal, or ASCII formats to display raw device or version 
information available from the device. Other device settings may provide the number of retries for a failed 
command and other functions. 
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The next section. Commands, provides a list of commands that the device may be instructed to carry 
out. For example, turning on or off an LED, as in the example set forth above. In the example provided 
above, the first number preceding the comma after the equal sign is a function number for the PHASTLink® 
and PHASTLink® protocol. The Commands section may also set forth the formats for command responses. 
5 FIGURES 6A-6F provides exemplary command setup windows that are displayed by installation software 
102 (FIGURE 3) using the command list in the configuration file. The list of commands displayed in the 
window is the collection of commands in the Commands section, which are located on the left side of the 
equal signs. The data on the right side of the equal signs are what is actually sent to the device when the 
corresponding command is selected. Further, the daU on the right side of the equal sign ftirther provide 
1 0 infmnation on whether the command requires a sUte variable, text variable or level variable. It may be seen 
from FIGURES 6A-6F, that the command windows prompt for the setting of these variables. 

The Events section describes events that occur in the device that are used to trigger something else. 
For example, "Key I Press" is an event on the device that is monitored. If this happens, then the data on the 
right side of the equal sign is sent to master controller 36. Master controller 36 may then send commands 
1 5 to other devices in the system in response to being notified of this trigger event 

The next section provide for Variable Definition of variables. The variable definition takes the foim: 
Type VarName=^InitiaIValue, {Range} ,Propcrty. The variable type may be boolean, number, level, state, or 
string. VarName is the text name of the variable, which is displayed in all dialog windows that refer to the 
variable. InitialValue is the value of the variable before any initialization occurs. The Range setting 
•20 provides the range of values the variable may be set to. Property is any special property of the variable, 
which may be of the following: 



Property 


Parameters 


Description 


ASCU 


None 


Converts the variable from ASCII data 


MAX 


Num 


Sets the maximum number of bytes to extract or 
compare 


PAD 


None 


Pads the data with leading zeros 


PROMPT 


None 


Prompts the programmer for the value in a command 


DELIM 


Char 


Sets the delimiter for the end of the string or value 


CHKSUM 


Num 


Checksums the data starting at byte number Num 



30 
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In the example above, the variable type is level, the variable name is "LED One Level", the initial value is 
zero (0), and the range is between 0 and 255, inclusive. 

The Variable Get section looks for matches in the input data in the same fonnat as command output 
and sets the value of the variables accordingly. The Variable Put section is used to update a device when 
5 installation software 1 02 sets or changes a variable. The label is the name of the variable that changed, and 
the data that follows after the equal sign is the command required to update the device. The Initialization 
section is used to initialize the device and may be omitted if the device includes firmware that implements 
the initialization process. 

Another section. Conditionals, are associated with the state variables defined for the device. The 
1 0 following variable types have the corresponding conditionals: 



Variable Type 


Conditionab 


Boolean 


If the variable is true or false 


Level 


If the variable is greater than» less than or equal to a specific 
value 


State 


If the variable is equal to: combo box of states 


String 


None 


List 


None 



Exemplary conditional dialog windows in the installation software programming window are shown in 

20 FIGURES 7A-7C. 

Included in the Appendix are an exemplary class declaration of the generic device interface object, 
an exemplary variable list, an exemplary command list, and an exemplary event list. 

It may be seen that, with the use of configuration files, the size of device interface object and 
installation sofbvare is not changed. The small size of the configuration files also enable them to be 

25 embedded into memory (e.g. read only memory) in the device for quick upload to the master controller when 
the device is brought on-line. Further, the process by which the devices may be installed is sufficiently 
flexible to allow either the insertion of the hardware device first or the configuring of the device interface 
object first and then attach them to one another. In addition, instead of the typical six month development 
time required to code a device driver for a new device, it now takes a matter of one or two days to fully 

30 implement the device configuration file. 
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Although several embodiments of the present invention and its advantages have been described in 
detail, it should be understood that mutations, changes, substitutions, transformations, modifications, 
variations, and alterations can be made therein without departing from the teachings of the present invention, 
the spirit and scope of the invention being set forth by the appended claims. 
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APPENDIX 

CLASS DECLARATION 



//- ^ 

5 //Description: Class declaration for the generic device interface module 

#ifndef_P3GENMOD_H_ 
Wefine _P3GENMOD_H_ 

10 

#ifhdefMCU_68000 

iHinclude ''..\basemod\basemod.h'* 
^include '*..V.Vhomeserv\attchman.h'* 

#else 

1 5 ^include '^MCU\Module$\basemod\basen1od.h'' 

iHinclude '^MCU^homeserv\attchnlan.h'' 

#endif 

^include "P3CommandList.h" 
20 ^include '*P31nitComniajidList.h" 

^include •*P3EventListJi" 

#include -P3 VariableListh" 

^include **P3SwitcherlnfoList.h'* 

^include ''P3VariableGetListh'' 
25 ^include •'P3GenConstants.h" 

^include '*P30utGoingCommandList.h'* 



// Classes that will be declared 
30 class CP3GenModObject; 
class CP3GcnModType; 



const int DEFAULTGENMOD^WIDTH = 30; 

35 const int DEFAULTGENMOD^HEIGHT = 30; 



// Type I>eftnitions 

typedef CP3GenModObject* LPP3GenModObject; 
40 typedef CP3GenModType* LPP3GenModType; 

extern LPP3GenModType lpP3GenModTypeMan; 

If 

45 // CP3GcnModObject 
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class CP3GenModObject : public PHASTObjcct 
I 

public: 

LPPSCommandList pCommandList; 

private: 

DWORD dwAttachlD; 
DWORD dwDcvicelD; 

//Device Information 
CString cManufacturer, 
CString cDeviceName; 
CString cHardwarcName; 
CString cAttachmentText; 
DWORD dwManufacturerNumber; 
DWORD dwDcviccNumben 
CString strActiveBmpFile; 
CString strlnactiveBmpFile; 

//Device Settings 
eDisplayType eDisplay; 

DWORD dwP3MessageSendDeIayTimerLength; 
DWORD dwP3MessageRetryTimerLength; 
DWORD dwRetiyCounl; 
DWORD dwMAXRetryCount; 



//Commands/events/conditionals 

LPPBResponseList pResponseList; 
LPP3EventList pEventList; 
LPP3 SwitcherlnfoList pSwitcherlnfo; 
LPP3InitCominandList plnitCommandsList; 

BOOL bHasEvcnts; 
BOOL bHasCommands; 
BOOL bHasConditional; 

BOOL bReadyToSendCommand; 

LPP3ResponseNode pCurrentCommandResponseNode; 

//Variable 

LPP3VariableList pVariableList; 
LPP3VariableGetList pP3VariableGetList; 

LPOutgoingCommandList pOutgoingCommandList; 
LPP3CommandList pVariablePutList; 
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public: 

CP3GenModObject(DWORD dwDevicelD, long IParentMapID, long IParentRoomlD, long 
IParentProgrammingObjectlD, long ISystemltemID, long IManufacturerlD, long IModellD); 



CP3GenModObjcct(DWORD dwLenglh. LPBYTE pbBuffcr); 

-CP3GcnModObject(); 

CBaseList ObjcctList; 

CBaseLtst SyncObjectList; 

void Initia)izeData(long ISysItemID); 
void BuildObjects(CString A); 
DWORD GetPNETType(); 

void FormalCommandString(DWORD &Length,LPBYTE pBuffcr, DWORD dwLength, 
LPBYTE IpData, const LPP3CommandNode ApCommandNode); 
void SetupModuleInfo(CString strParamaters); 

LPP3 SwitcherlnfoList GetSwitcherPti<); 



//Device specific methods: 
/♦virtual*/ void DeleteQ; 

// General methods: 
#ilhdefMCU 

/♦virtual*/ HBITMAP GetBitmap(); 

/♦virtual^/ void GetBitmaps(HBlTMAP&. HBITMAP&, long. CRectA); 
/♦virtual^/ void LaunchPropertiesDialogO; 

DWORD GetAudioZoneII){){retuni NULL; }; 

#endif 

/♦virtual^/ LPPHASTObjectType GetType(); 

// Programming methods: 
#ifndefMCU 

/♦virtual*/ CBaseCommandDIg * NewCommandWindov^(CWnd ♦); 

/♦virtual*/ CBaseConditionalDIg * NewConditionalWindow{CWnd ♦); 

/♦virtual*/ BOOL HasCommandWindow(); 

/♦virtual*/ BOOL HasConditionalWindov^); 

/♦virtual*/ BOOL HasEventsWindowO {return FALSE; }; 

/♦virtual^/ CString GetFunctionDescription(DWORD, DWORD, LPBYTE); 

/♦virtual^/ CString GetFunctionEngraving(DWORD, DWORD, LPBYTE); 

/♦virtual*/ CString GetConditionalDescripiion(DWORD, DWORD, LPBYTE); 

/♦virtual*/ CString GetEventDesc(long eventID); 
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CSlring GetOutBoundPackctDescription(DWORD dwLength, LPBYTE 

IpData); 

CString GetlnBoundPacketDescription(DWORD dwLength, LPBYTE 

IpData); 

5 void AddCharFromHex(BYTE ♦buf^ DWORD &dwLength_. BYTE 

data J; 

#endif 

/♦virtual ♦/ BOOL EvaluateConditionaI(DWORD, DWORD, LPBYTE); 
10 /♦virtual*/ inl GetNumEvents(); 

/♦virtual*/ void GetEvents(long *pEventlDs); 

// Network methods: 
/♦virtual*/ DWORD GetScrialSizc(); 
1 5 /*virtual*/ void Seria)ize(LPB YTE); 

/♦virtual*/ void Deseriali2e(DWORD, LPBYTE); 
/*virtual*/ void HardwareNotify(BOOL); 

CString CreateString(consl LPBYTE AphBuffer, DWORD &dwPos); 
20 DWORD lnsertVariabIeInCommand(DWORD &Length, LPBYTE 

pBuffer, DWORD dwVarValue, DWORD dwVarPos, const LPP3VariableNode pNode); 

void SendNextCommaDdQ; 
void RemoveCommandFromListO; 
25 void TimerCallBack (DWORD timerlD); 

void AddToSendBuffcr(DWORD dwPriority, DWORD dwLength, 
LPBYTE pBuffer, LPP3CommandNode pCommandNode); 



30 

// Attachment methods: 

/♦virtual*/ void FiltAttachments(); 

/♦virtual*/ void UnAttachObjectNow(DWORD); 

/*virtual*/ DWORD Atlach(DWORD dwObjecUD, DWORD dwAttachType, DWORD 
35 dwAttachPlags); 

/*virtual*/ DWORD AttachFunction{DWORD dwObjcctID, DWORD dwAttachID, DWORD 
dwFunctionlD, DWORD dwLength, LPBYTE IpData); 

/♦virtual^/ void Dataln(DWORD dwLength, LPBYTE IpData); 



40 



#ifndefMCU_68000 
il^endif 



//probably not need in MCU 
45 BOOL lsAudioAttached(DWORD dwObjectlD); 

// System Created Variables 

// 
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// void RegisterVariables{); 

// void RenameVariablesQ; ^ 
void Delete VariabiesQ; 

/♦virtual*/ CString GetVariabieNaine(int nType); 
5 /♦virtual*/ void VariableChanged(BYTE ♦pNewValue); 

/♦virtual*/ void GetConnections (CBaseList&); 
// /♦virtual*/ void Check VariabiesQ; 
// /♦virtual*/ void SetDeviceName (CString cDeviceName^); 

10 private: 

DWORD dwDataStringLcngth; 



DWORD ParseObjectForDWORD(const CString & strParam, const CString & strKey); 
15 CString ParseObjectForString(const CString & strParam, const CString & strKey); 



}; 

20 typedef CP3GenModObject ♦ LPP3GenModObjecl; 



45 



//- 



//CP3GenModType 

25 class CP3GenModType : public PHASTObjectTypc 
{ 

public: 

CPBGenModTypeO; 
~CP3GenModType(); 

30 

#ifiidefMCU 

/♦virtual*/ int GetBitmapID(); 
/*virtual*/ int GetToolBarBitmaplDO; 
35 /*virtual*/ int GetToolBarMasklDO; 

/♦virtual*/ HCURSOR GetCursor(); 
/*virtual*/ HBITMAP GetBitmap(); 

«endif 

/♦virtual ♦/ WORD GetVersion(); 
40 /♦virtual ♦/ WORD GetID(); 

/♦virtual^/ LPPHASTObject NewObject(long, long, long, long, long, long); 
/♦virtual*/ LPPHASTObject NewObject(DWORD, LPBYTE); 
/♦virtual^/ void DeletePHASTObject(LPPHASTObject); 



); 

#endif 
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VARIABLE LIST 

// File: GcnComboObjectList.h 

// Purpose: Declare node types Contact, Relay, IR and Serial. 
// 

// PHAST(c)1999 

#ifhdef_CP3VARIABLELIST_H_ 
^define _CP3 VARIABLELIST_H_ 



#ifndefMCU_68000 

^include "..V.WHomeServVAttchman.h" 

^include "..V.WHomeServVBaseList.h" 

#else 

^include "XMClAHomeServXAttchman.h" 
^include •UiClAHomcseivXBaseListh" 
^endif 

^include "..V.VHomescrvWariableManagcr.h" 
class CP3GenModObject; 

fl. 

//CP3VariableNodc 

class CP3VariableNode : public CBaseNode 
{ 

public: 

DWORD dwVariablcType; 
DWORD dwVarlD; 

BOOLbHiddcn; 
BOOL bASCII; 
DWORD dwMaxBytcs; 
char chDeiim; 
BOOL bConfigPagc; 
BOOL bPromptUser; 
BOOL bPad; 

DWORD dwChecksumStart; 
int MinRange; 
int MaxRange; 



// LPVariabiePut IpVariabiePut; 
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public: 

CP3VariabIeNode(); 

CP3 VariableNode{DWORD dwLength, LPBYTE pBuffer); 

5 // CP3VariableNode(DWORD dwVariableSystemlD, DWORD dwVariableType, BOOL bAscii, 
DWORD dwMaxBytes, 

// char chDelim, BOOL bConfigPage, BOOL bPromptUser, BOOL bPad. 

// DWORD dwChccksumStart/*, LPVariablcPut IpVariablePutV. BOOL bHiddcn); 

10 --CPS VariableNode(){ } ; 

CString GetVariableNameO; 

DWORD Sca!eLevelVaJue(DWORD dwVaJue); 

1 5 WORD ParseSerialString (CString cinput, LPBYTE pOutput, inl maxOutputLen); // re- 

call this externally 

void SetVariabIeValue{DWORD varlD, DWORD dwVarValue); 

DWORD GetVarValueFroniDataIN(DWORD dwUngth, LPBYTE IpTempData, DWORD 
dwVariablePos); 



20 



25 



/♦virtual*/ DWORD GetSerialSize(); 
/♦virtual*/ void Serialize(LPBYTE); 
/♦virtual*/ void Deserialize(DWORD, LPBYTE); 

}; 



typedef CP3VariableNode* LPP3VariableNode; 



30 //- 



// CXSerialCommandList 

class CP3VariableLtst : public CBaseList 
{ 

35 

int nPos; 
CString cString; 
// CString cDeviceName; 

40 CP3GenModObject ♦ pGenModObject; 

public: 

CP3VariableListO; 

45 

CString ParseVariables(CString cString); 
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CP3VariableNode ♦ GetNodeByVariableName(CString); 
CP3VariabIeNode ♦ GetNodeByVariablelD(DWORD); 

//variable parsing functions 
5 LPLevelVariable GetLevelVariabIeInfo(CString cVarNamcStr. LPP3 VariableNode 

pTempP3Var); 

LPNumberVariable GetNumberVanablelnfo<CString cVarNameStr); 
LPBoolean Variable GetBoolVariablelnfo(CString cVarNameStr); 
int GetNunnberInParen(CString _cTempString); 
10 void SetVariableParams(LPP3VariableNode IpTempVariableNodc); 

CString GetQuotedTextStringO; 

LPEnumeratedVariable GetState Variable] nfo(CString _cStateVarNaincStr); 
CString GetVanableNanie(); 
DWORD GetVaribleType(); 

15 

/♦virtual*/ DWORD GetScriaiSize(); 
/♦virtual*/ void SeriaIi2e(LPBYTE); 
/♦virtual ♦/ void Deseriali2e(DWORD, LPBYTE); 

20 

); 



typedef CP3VariabIeList* LPP3VariabIeList; 

25 

#endir 
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COMMAND LIST 

// File: GenComboObjectList.h 

// Purpose: Declare node types Contact, Relay, IR and Serial. 
5 // 

// PHAST(c)1999 



#ifndef_CP3COMMANDLIST^H_ 
1 0 #define _CP3COMMANDLlST_H_ 



#ifhdefMCU_68000 
^include "..V.WHomeServXAttchniaii.h'* 
1 5 ^include "..\SoftCntc\SoftCntc Ji" 

#include ".A..\\HomeServ\BaseList.h" 
#else 

^include "\MCU\HomeServ\Attchinan.h" 
#include *AMCU\Modules\SoftCntc\SoftCntc.h" 
20 ^include •^MCU\HoInese^v\BaseList.h- 
#endif 

^include T3VariableList.h" 
#include "CZOMString.h" 
25 #include TBCommandVariableList.h'* 



If 

// CP3ResponseNode 

30 

class CP3ResponseNode : public CBaseNode 
{ 

public: 

35 DV/ORD dwFunctionlD; 

DWORD dwMessagcTypelD; 
LPZOMString IpResponseData; 
LPContmandVariableList IpCommandVarList; 

40 public: 

CP3ResponseNode(DWORD dwMessageTypelD, BYTE ♦ j)ResponseData, 
LPCommandVartableList^pTempCommandVariableList, 
DWORD dwFunctionID, int nLength); 

45 BOOL CompareResponseData(DWORD dwLenglh, LPBYTE IpData); 

CP3ResponseNode(); 
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-OPS ResponseNode(); 

DWORD GetSerialSizeO; 
void Seria!ize(LPBYTE pBuffer); 
5 void Deserialize(DWORD dwLength, BYTE * pBuffer); 

}; 

typcdef CP3ResponseNode * LPP3ResponseNode; 

10 

//- 

// CP3CommandNode 

class CPSResponseList : public CBaseList 
15 { 

public: 

CP3ResponseLisl(); 
-CP3RcsponseLisl(){ } ; 

20 

DWORD GetSerialSizeO; 

void Scrialize(LPBYTE pBuffer); 

void Deserialize(DWORD dwLength, BYTE * pbBuffer); 

25 ); 

typedef CP3ResponseList ♦ LPP3ResponseList; 



30 II 

// CP3CommandNode 

class CP3CominandNode : public CBaseNode 

{ 

35 public: 

// DWORD dwNodelD; 

DWORD dwFunctionID; 
BOOLbHidden; 
40 DWORD dwMessageTypelD; 

LPZOMString IpCommandData; 
LPCommandVariableLisl IpCommandVarList; 
CP3ResponseNode ♦IpResponse; 

45 

public: 
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10 



25 



CP3CommandNode(CString_cCommandName, DWORD _^dwMessageTypeID, BYTE * 
_cCommandData, 

LPCommandVariablcList j[)TeinpCommandVariabIeList, 
BOOL bHidden. DWORD dwFunctionID, int nLength); 

CP3CommandNode(); 
-CPBCommandNodeO; 



WORD ParseSerialString (CString clnput, LPBYTE pOutput, int maxOutputLen); // <- 
call this externally 



DWORD GetSerialSizeO; 
1 5 void Serialize(LPBYTE pBuffer); 

void Deserialize(DWORD dwLength, BYTE ♦ pBuffcr); 

}; 

20 typedef CP3CominandNode ♦LPP3CommandNode; 



//-■ 



// CXSerialCommandList 

class CP3ComniandList : public CBaseList 
{ 

DWORD NextCommandID; 



30 public: 

CP3CommandList(); 
'-CP3CommandListO{ } ; 

35 DWORD GetNextFunctionlDO; 

BOOL ParseCommands(CStnng_cStnng, LPP3ResponseList IpResponseList, const 
LPP3 VariableList cVarList); 

40 int ASC]IHexToInt(CSuring ^cHexChar); 

CString GetComniandName(const CString &_cString, int &_nPos); 

LPP3CommandNode GetNodeByCommandNaine(CString); 

void SetupVanables(LPP3VariableList pVariablcList, LPP3ResponseList pResposneList); 

45 

DWORD GetSerialSizeO; 

void Seriali2e(LPBYTE pBuffer); 
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void Deserialize(DWORD dwLength, BYTE * pbBufFcr); 

}; 

typedef CP3CoinmandList * LPP3CommandList; 
^endif 
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EVENT LIST 

//File: GenComboObjeclListh 

// Purpose: Declare node types Contact, Relay, IR and Serial. 
5 // 

// PHAST(c)l999 



#ifhdef_CP3EVENTLIST_H_ 
1 0 #define _CP3EVENTLIST_H_ 



#ifndcfMCU_68000 
#iiiclude ''..\.A\HonieServ\Attchman.h'' 
15 ^include '•..\..\\HomcServ\BaseList.h'' 
#else 

#include 'MV!CU\HomeScrv\Attchman.h- 
^include "\MCU\Homeserv\BaseList.h" 
#endif 

20 

#include "CZOMString.h" 

//. 

//CP3EvcntNode 

25 

class CPBEventNode : public CBaseNode 
{ 

public: 

30 DWORD dwEventID; 

int nMessageTypelD; 
LPZOMString IpEventData; 

public: 

35 CP3EventNodeO; 

CP3EventNode(DWORD dwLength, LPBYTE pbBuffer); 

CP3EventNode(CString _cEvcntName, DWORD ^dwEvcntlD, BYTE ♦ jEventData, int 
nLength, tnt _nMessageTypelD); 
40 ~CP3EventNodeO; 

DWORD GetSerialSizeO; 

void Serializc(LPBYTE pBufTer); 

void Deserialize(DWORDdv^Length, BYTE ♦ pbBuffer); 

45 

private: 
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}; 

typcdef CP3EventNode* LPP3EventNode; 



class CP3£ventList : public CBaseList 
{ 

] 0 DWORD dwNextEventID; 

public: 

CP3EventListO; 
15 -CP3EventList(); 

CString ParseEvcnts(CString cString, DWORD dwObjectID); 

LPP3EventNode GetNodeByEventNaine(CString); 
20 LPP3EventNode GetNodcByEvenUD(DWORD); 

DWORD GetNextEventID{); 

CString GetEventNaine(CString &cString, int &nPos); 
int ASCI]HexToInt(CString_cHexChar); 

void Coinpare£vent(DWORD dwLenglh,LPBYTE IpData, DWORD ObjcctID); 
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30 



DWORD GctSerialSizeO; 

void Serialize{LPBYTE pBuffcr); 

void Deseria!ize(DWORD dwLength, BYTE ♦ pbBuffer); 

); 

typedef CP3EventList* LPP3EventList; 
#endif 



35 
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WHAT IS CLAIMED IS : 

i . A control system, comprising: 
a master controllen 

at least one device coupled to the master controller via a network; 
5 at least one generic device interface module residing on the master controller, the at least one 

device interface module defining a basic protocol for interface with any device; and 

configuration information associated with the at least one device being operable to tailor the at 
least one generic device interface module to communicate and operate with the at least one device. 

10 2. The control system, as set forth in claim I, further compnsing at least one instance of the 

at least one generic device interface object residing on the master controller and having the configuration 
infonnation associated with the at least one device. 

3. The control system, as set forth in claim 1, wherein the configuration information is 
1 5 described in a configuration file residing in the master controller. 

4. The control system, as set forth in ciaini 1, wherein the configuration information is 
described in a configuration file residing in a data storage device accessible by the master controller. 

20 5. The control system, as set forth in claim 1, wherein the configuration information is 

described in a configuration file residing in the at least one device, the configuration file being 
uploadable to the master controller. 

6. The control system, as set forth in claim 1, wherein the configuration infonnation 
25 comprises information related to the manufacturer and model of the at least one device. 

7. The control system, as set forth in claim 1 , wherein the configuration information 
comprises a unique manufacturer number representative of the at least one device manufacturer and a 
unique device number representative of the model of the at least one device. 

30 
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8. The control systein, as set forth in claim 1, further comprising a display coupled to the 
master controller, wherein the configuration information comprises data related to the display 
representation of the at least one device on the display. 

5 9. The control system, as set forth in claim 1, further comprising a display coupled to the 

master controller, wherein the configuration information comprises a bitmap file of an icon 
representation of the at least one device. 

10. The control system, as set forth in claim 1, wherein the configuration information 
10 comprises a defmition of commands and format which the at least one device is responsive to. 

1 1 . The control system, as set forth in claim I, wherein the configuration information 
comprises a definition of variables and format which the at least one device is responsive to. 

15 12. The control system, as set forth in claim i , wherein the configuration information 

comprises a definition of events and format which the at least one device is responsive to. 

13. A method of communicating with a device in a control area network, comprising: 
automatically obtaining configuration information associated with the device, the configuration 
20 file including communication and operating protocol of the device; 

instantiate a specific instance of a generic device interface object using the configuration 
information associated with the device; and 

communicating with the device via the specific object instance. 

25 14. The method, as set forth in claim 13, further c(»npristng: 

connecting the device to the control area network; and 

uploading the configuration information from the device via the control area network. 

1 5. The method, as set forth in claim 13, further comprising: 
30 connecting the device to the control area network; 

obtaining version information associated with configuration information in the device; 
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comparing the obtained version information and version information associated with 
conflguration information available at a master controller; and 

uploading the configuration information from the device via the control area network in response 
to the configuration information therein having a later version. 

S 

16. The method, as set forth in claim 13, further compnsing: 
displaying a sofbvare icon representative of the specific object instance; 
displaying a device icon representative of the device; and 
associating the sofhvare icon and device icon with one another. 

10 

17. The method, as set forth in claim 13, wherein automatically obtaining configuration 
information further comprises reading a configuration file having device information related to the 
device. 

15 18. The method, as set forth in claim 1 7, wherein reading the configuration file comprises 

reading a unique manufacturer number and a unique device number associated with the device. 

19. The method, as set forth in claim 1 7, wherein reading the configuration file comprises 
reading an icon bit map file associated with the device. 

20 

20. The method, as set forth in claim 1 7, wherein reading the configuration file comprises 
reading a version number associated with the configuration file. 

21 . The method, as set forth in claim 17, wherein reading the configuration file comprises 
25 reading display information associated with the device. 

22. The method, as set forth in claim 13, wiierein automatically obtaining configuration 
information further comprises reading a configuration file defining commands operable to be performed 
by the device. 

30 

23. The method, as set forth in claim 13, wherein automatically obtaining configuration 
information further comprises reading a configuration file defining events that may occur at the device 
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and the corresponding data to be generated by the device and sent over the control area network in 
response to the occurrence of the event. 

24. The method, as set forth in claim 13, wherein automatically obtaining configuration 

5 infonnation further comprises reading a configuration file defming variables associated with operations 
of the device. 

25. A control area network, comprising: 
a master controller; 

10 at least one device coupled to the master controller via a local area network; 

at least one generic device interface object residing on the master controller, the at least one 
device interface object defming a basic protocol for interface with any device; and 

a configuration file associated with the at least one device being operable to tailor the at least one 
generic device interface object to generate a specific interface object instance operable to communicate 
1 5 and operate with the at least one device. 

26. The control area network, as set fcHth in claim 25, wherein the configuration file resides 
in the master controller. 

20 27. The control area network, as set forth in claim 25, wherein the configuration file resides 

in a data storage device accessible by the master controller. 

28. The control area network, as set forth in claim 25, wherein the configuration file resides 
in the at least one device, the configuration file being uploadable to the master controller. 

25 

29. The control area network, as set forth in claim 25, wherein the configuration information 
comprises infonnation related to the manufacturer and model of the at least one device. 

30. The control area network, as set forth in claim 25, wherein the configuration file 

30 comprises a unique manufacturer number representative of the at least one device manufacturer and a 
unique device number representative of the model of the at least one device. 
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31 . The control area network, as set forth in claim 25, further comprising a display coupled 
to the master controller, wherein the configuration file comfNises data related to the display 
representation of the at least one device on the display. 

32. The control area network, as set forth in claim 25, further comprising a display coupled 
to the master controller, wherein the configuration file comprises a bitmap file of an icon representation 
of the at least one device. 

33. The control area network, as set forth in claim 25, wherein the configuration file 
comprises a definition of commands and format which the at least one device is responsive to. 

34. The control area network, as set forth in claim 25, wherein the configuration file 
comprises a definition of variables and format which the at least one device is responsive to. 

35. The control area network, as set forth in claim 25, wherein the configuration file 
comprises a definition of events and format which the at least one device is responsive to. 
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